home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / stkrpat.lzh / READ_ME.TXT < prev    next >
Text File  |  1992-01-17  |  15KB  |  348 lines
  1.                    STalker™ 3.00 to 3.01 Patch Program
  2.  
  3.             This program will upgrade STalker version 3.00 to
  4.             version 3.01.  It will ONLY upgrade version 3.00.
  5.  
  6.   This program is copyright © 1991 by Gribnif Software.  All rights are
  7.   reserved.  This program may be freely distributed to all legitimate
  8.   registered users of STalker 3.
  9.  
  10.   Any questions or comments, please contact us at:
  11.  
  12.       Gribnif Software, P.O. Box 350, Hadley, MA 01035, USA
  13.       Tel: (413) 584-7887, Fax: (413) 584-2565
  14.       GEnie: GRIBNIF
  15.  
  16.  
  17. What is needed to upgrade
  18. =========================
  19.  
  20.   1.  An un-modified, registered, STalker 3 Master Disk, version 3.00.
  21.  
  22.   2.  A hard disk or a blank formatted floppy disk (to place the
  23.       PATCH301.PRG and PATCH301.DAT on).
  24.  
  25.  
  26. How to upgrade your STalker version 3.00 to version 3.01
  27. =========================================================
  28.  
  29.   1.  Make sure you have made a backup copy of the STalker 3 Master Disk.
  30.  
  31.   2.  Place the PATCH301.PRG and PATCH301.DAT on your hard disk or on the
  32.       blank floppy disk (it may need the extra disk space to write some
  33.       temporary files, depending on free memory.)
  34.  
  35.   3.  Run the PATCH302.PRG and follow the on-screen prompts.
  36.  
  37.   4.  Once you have finished upgrading your master disk to version 3.01,
  38.       make a backup copy of this newer version.
  39.  
  40.   ** VERY IMPORTANT STEP, READ CAREFULLY **
  41.  
  42.   5.  To install the newer version on your system, you MUST replace the
  43.       following STalker 3.00 files in your system with the 3.01 version
  44.       files from the newly upgraded disk:
  45.       
  46.       \STALKER.ACC
  47.       \STALKER.PRG
  48.       \STALKER.RSC
  49.       \BACKTALK\SCRIPTS\PREFIX.BTS
  50.       \BACKTALK\SCRIPTS\BUF_SIZ.BTS
  51.       \BACKTALK\SCRIPTS\BUF_SIZ.BTK
  52.       \BACKTALK\BACKTALK.PRG
  53.       \BACKTALK\BUF_SIZ.BTK         -- Same as the one in SCRIPTS folder
  54.       \EXTRAS\AUXINIT.PRG
  55.  
  56.       You will also find these two files with this upgrade, and they should
  57.       be copied to your scripts directory:
  58.      
  59.       WRITESCR.BTS
  60.       WRITESCR.BTK
  61.       
  62.       Additionally, since the first few copies of STalker sold had a
  63.       faulty version of INF_CONV.PRG, a corrected one has also been
  64.       included with the patch program.
  65.       
  66.  
  67. If you get an error message
  68. ===========================
  69.  
  70.   If your STalker 3 Master Disk has been modified in any way (including
  71.   moving files around), the patch program will not be able to perform
  72.   the upgrade.  You will get an error message indicating that this has
  73.   happened.  In this case. you should mail us the disk so that we can
  74.   upgrade it.
  75.  
  76.   To have your disk upgraded by us, you need to:
  77.  
  78.   1.  Send in your original, registered, STalker 3.00 Master Disk.
  79.   2.  Enclose a U.S. check for $5 + $2 shipping & handling ($7 total).
  80.   3.  Enclose a note with your name, address, and daytime phone number.
  81.  
  82.   In return you will receive the upgraded 3.01 Master Disk.
  83.  
  84.  
  85. Changes for STalker 3.01 - Jan. 15th 1992
  86. =========================================
  87.  
  88. This version contains the following enhancements:
  89.  
  90. + The efficiency of the transfer protocols (ZModem mainly) was improved by
  91.   speeding up some of the most common low-level routines.
  92.  
  93.   The "Favour concurrency" option was also made a bit more black & white.
  94.   At 9600 baud or greater with Favor Concurrency off, you won't be able to
  95.   do much else on the machine since STalker will be aiming for maximum
  96.   throughput.  If you need to abort a high-speed file transfer, use the
  97.   UNDO key rather than attempting to click on the Abort button.  On faster
  98.   machines, either will probably work, but on a stock 8MHz machine STalker
  99.   may not process the mouse button.
  100.  
  101. + If the file transfer window is currently on the screen, the INSERT key
  102.   will allow you to alternate between the STalker window and the transfer
  103.   window.
  104.  
  105. + STalker will now automatically expand the serial input buffer of a port
  106.   if it is less than 2K.  The output buffer is not changed since it is not
  107.   as important to proper operation of STalker.
  108.  
  109.   In program mode STalker checks the buffer size each time you change
  110.   ports, so if you use several port in a session, you'll end up giving each
  111.   a 2K buffer.
  112.  
  113.   In accessory mode, it will only expand the port's buffer during initial
  114.   startup since that is the only time that STalker can safely allocate
  115.   extra memory from TOS.  If your configuration indicates use of port X and
  116.   you switch to port Y during the session, port Y's buffer will not be
  117.   expanded.
  118.  
  119. + New versions of AUXINIT and the BUF_SIZE BackTALK script have been
  120.   included.  The new AUXINIT handles TT and Mega STe ports in addition to
  121.   the ST serial port.  You'll need to run a separate copy for each port
  122.   whose buffer you wish to expand.  Simply create as many copies as you
  123.   need in your AUTO folder and then use the BUF_SIZE BackTALK script to set
  124.   them up. Please note that if you have TOS 1.4 or newer, you can probably
  125.   use a buffer size of more than 31k (up to 63k) without a problem.
  126.  
  127. + The Atari-standard clipboard format is now supported.  To enable the
  128.   Atari-format clipboard, set the "Clipboard drive" in the Preferences
  129.   dialog to "Z".  Any other drive will cause STalker to use the old method
  130.   which is compatible with older STalker/STeno programs. STeno 2.00 uses
  131.   the "old" format; later versions will use the new one.
  132.  
  133.   Note that the Atari method requires scanning of a directory in order to
  134.   determine if a scrap is available, so to avoid a lot of extra physical
  135.   disk I/O, use a program such as CACHEXXX.PRG that caches directory
  136.   entries.
  137.  
  138. + Support has been added for specifying scripts to invoke at startup via
  139.   the command-line.  This allows you to "Install" STALKER.PRG as the
  140.   application for files of type .BTK.  STalker will attempt to execute each
  141.   file specified on the command line in turn, after it first executes the
  142.   normal startup scripts.
  143.  
  144.   If a qualified filename is given, i.e., something like C:\GO.BTK, STalker
  145.   will attempt to access the file exactly as specified.  If just a filename
  146.   is given, ex. "GO.BTK", STalker will look in the default directory.
  147.  
  148. + A new BackTALK command, "exit_program()" was added.  It returns nothing
  149.   and takes no parameters.  If STalker is operating in program mode, it
  150.   will cause STalker to terminate immediately.  In accessory mode the call
  151.   does nothing and returns immediately; you can use this fact to take
  152.   whatever actions are appropriate in accessory mode by placing statements
  153.   after the exit_program() call.  For example:
  154.  
  155.     ...  exit_program();
  156.                   // If the script gets here, we must be in ACC mode.
  157.          exit(0); // (or whatever is appropriate)
  158.  
  159. + There is now a "write_script()" BackTALK command.  This function watches
  160.   data from the host and the user and builds a script containing a sequence
  161.   of wait_for() / port_send() commands.  Included is the file WRITESCR.BTS,
  162.   which is a small script that does the necessary stuff before calling
  163.   write_script(). Pressing Control-Z will terminate WRITESCR.BTK.
  164.  
  165.   Please note that scripts which are generated by this command are fairly
  166.   basic. Some tweaking may be necessary, and things such as file
  167.   downloading are not recorded. Function keys are referenced by their
  168.   number, which means that if a script relies on the F1 key and you change
  169.   the assignment of F1, the script may cease to work as expected.
  170.  
  171.   For documentation on the actual format of write_script(), see the
  172.   file WRITESCR.BTS.
  173.  
  174. + A set_time() BackTALK function was added.  This is the converse of the
  175.   get_time() call, and takes one parameter which should have the desired
  176.   date and time packed into it in the same format returned by get_time().
  177.   Internally, this function sets both the XBIOS and GEMDOS time and date.
  178.  
  179. + NOTE:  SCRIPTS COMPILED WITH THIS VERSION MAY NOT WORK PROPERLY UNDER
  180.   STALKER 3.00!!  This is due to the AND/OR enhancement described below.
  181.   If your script does not use the keywords AND, OR, or their && and ||
  182.   equivalents, and does not cal